home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1994 January / PSL Monthly Shareware CD-ROM (Public Software Library) (January 1994).iso / games / dos / misc / bugsali.com / BUGS.DOC < prev    next >
Encoding:
Text File  |  1990-08-28  |  14.9 KB  |  379 lines

  1.  
  2.  
  3.  
  4.                                 Bugs Alive
  5.  
  6. Bugs Alive is an evolution simulation program. It has the challenge of a
  7. game while at the same time it teaches about the processes that drive
  8. natural selection. It challenges the user of the program to set up an
  9. environment and then to explain how and why things change. (Program
  10. requires EGA color graphics.)
  11.  
  12. The program consists of plants, bugs, and predators.
  13.  
  14. PLANTS
  15.  
  16. The plants are almost round structures that are green in the summer and
  17. turn gray in the winter1. They can only grow in certain areas of the
  18. screen. The number of fertile areas for plant growth can be controlled by
  19. using the Density statement in a control file. The Pattern statement can
  20. also be used to create a specific pattern of fertile areas on the screen.
  21. It will override the density statement. The Growth statement controls the
  22. rate of plant growth in the summer and death in the winter.
  23.  
  24. BUGS
  25.  
  26. The bugs are little colored squares that swarm around the screen eating the
  27. plants, growing, and reproducing. There are three sizes and six colors that
  28. indicate the energy of each bug. The larger the size the higher the energy
  29. level. When a bug has acquired sufficient energy from eating green plants
  30. and if it is summer the bug will split (asexual reproduction). At this
  31. point of reproduction several factors can change; i.e.
  32.  
  33.      o Visual Range      Farthest distance can see plants
  34.      o Energy Use        Efficiency of plant use for energy
  35.      o Death Run Point   Energy level for start of Death Run
  36.      o Hibernate         Presence or absence of Hibernate factor
  37.  
  38. These factors will either increase, decrease or remain unchanged. The
  39. change or mutation rate at this point is very high, several orders of
  40. magnitude higher than a real situation. However, who wants to run a program
  41. for several months or years in order to notice change.
  42.  
  43. Bugs can only see food in the direction in which they are moving and are
  44. limited to a fixed visual range. This visual range can change at the time
  45. of reproduction. The value listed in the report is the average for the
  46. population.
  47.  
  48. When a bug's energy level drops below a certain point, the bug will pick a
  49. random direction and move in that direction until it either finds green
  50. plants or dies. This is the Death Run. The average point at which the Death
  51. Run for the population starts is given in the report file.
  52.  
  53. The Bug population starts out with about five percent of the bugs having a
  54. hibernation factor. This factor also has a five percent mutation rate at
  55. reproduction. If a Bug has this factor and their energy efficiency level is
  56. below a given point2 then they hibernate during the winter to save energy.
  57. A hibernating Bug will appear to freeze on the screen.
  58.  
  59. The environment wraps around on the screen; left to right and top to
  60. bottom. The bugs do not notice this and are able to pass and see across
  61. these transitions.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. The Number command in the command file can be used to establish an initial
  71. number of bugs this can be anywhere from 1 to 500. However, the greater the
  72. number of Bugs and predators the slower the program will run. When the last
  73. Bug has died the program will terminate.3 If a large number of bugs are
  74. produced they will begin to feel population stress and die a natural death
  75. at a faster rate.
  76.  
  77. Predators
  78.  
  79. Predators appear on the screen as small circles. While they have only one
  80. size they do change color as their energy levels change. Predators remain
  81. stationary unless they are chasing a Bug. This is because they use a much
  82. higher level of energy when moving.
  83.  
  84. Predators also have several factors that can change when reproduction
  85. occurs (also asexual). These factors are;
  86.  
  87.      o Visual Range           Distance can see Bugs
  88.      o Speed                  Speed of movement
  89.      o Energy Use             Efficiency use Bugs for energy
  90.  
  91.  
  92. The visual range for the predators is the base visual range at which they
  93. can see the smallest Bug. Larger bugs can be seen at slightly greater
  94. distances depending on size. It is only the base visual range that can
  95. change during reproduction.
  96.  
  97. The speed which a Predator moves after a Bug is also subject to change at
  98. the time of reproduction. The slowest that a Predator will move is the same
  99. as the Bugs. However, with selection and change they can move up to five
  100. times faster.
  101.  
  102. Energy use for Predators is almost the same as for Bugs except that
  103. Predators eat Bugs. This means that energy use indicates how much energy a
  104. Predator can get from a bug, above the basic level.
  105.  
  106. Unless a Zero Predator option is chosen in the Predator statement in the
  107. control file a new predator will periodically wander into the environment.
  108. The default rate is once in ten years, however, this can be changed with
  109. the Addpredator statement in the control file.
  110.  
  111. While Predators can travel across the boundaries at the edges of the screen
  112. because they can not see across these boundaries they rarely cross them.
  113.  
  114. Control File
  115.  
  116. There is only one command line option when starting the program. The name
  117. of a control file. This file when present contains a series of statements
  118. that can adjust some of the variable aspects of the Bug's environment. Each
  119. command in the control file is case insensitive i.e. the letters can be any
  120. mixture of upper and lower case. There is also no defined order to their
  121. appearance or requirement that they appear. A control file could contain as
  122. few as a single statement.
  123.  
  124. Below is a control file and description of each statement. The descriptions
  125. should not be included within the control file.
  126.  
  127. number 30                     Number of starting bugs (1-500);
  128. growth 10                     Rate of plant growth (1-100);
  129. plant 150                     Number of initial plants (1-1000);
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. density 25                    Number of fertile land locations (1-50);
  137. summer 3                      Length of summer, 100 pixel moves (1-100);
  138. predators 3                   Starting predator number (0-50);
  139. addpredator 15                Add predator on average every # years (1+);
  140. linked negative               Link change in visual range and energy use
  141.                                  (positive, negative)
  142. pattern 1 OOOOXXXXOOOO        Create pattern of plant growth  by row
  143. pattern 2 OOOXXOOXXOOO        number. X's are locations for plants. This
  144. pattern 3 OOXXOOOOXXOO        statement overrides density;
  145. pattern 4 OXXOOXXOOXXO
  146. pattern 5 XXOOXXXXOOXX
  147. pattern 6 XXOOOOOOOOXX
  148.  
  149.      Number 30
  150.  
  151.      The number statement can be used to establish the initial number of
  152.      bugs when the program starts. The statement above would start the
  153.      program with thirty bugs. If this statement is not included or a
  154.      control file is not used then a default number of bugs somewhere
  155.      between 5 and 20 will be produced. The number of starting bugs that
  156.      this statement will accept must fall somewhere between 1 and 500.
  157.      Exceeding this range will result in five Bugs as a starting value.
  158.  
  159.      Growth 10
  160.  
  161.      The growth statement is used to control the rate of plant growth in
  162.      the summer and plant death in the winter. It uses an ordinal number
  163.      falling between 1 and 100. The higher this number the greater the rate
  164.      of plant growth and death.
  165.  
  166.      Plant 150
  167.  
  168.      Plant is a statement that controls the initial number of plants on the
  169.      screen when the first summer starts. It uses an ordinal number falling
  170.      between 1 and 1000. The higher this number the more plants present at
  171.      summer.
  172.  
  173.      Density 25
  174.  
  175.      The density statement controls the number of locations of fertile land
  176.      where plants can grow. These locations will be randomly distributed
  177.      throughout the screen. The range of values can fall between one and
  178.      fifty. If a pattern statement is used this statement need not be
  179.      included as it will be overridden.
  180.  
  181.      Summer 3
  182.  
  183.      Summer is a statement that controls the length of summer and winter.
  184.      The seasons are measured in one hundred bug moves. A three as given
  185.      above would indicate that summer will last three hundred bug moves.
  186.      Winter is always one third the length of summer. The range of possible
  187.      choices is one to one hundred. While the seasons are progressing a bar
  188.      will grow4 in the bottom line of the screen so that you may judge the
  189.      relative time within the season.
  190.  
  191.      Predators 3
  192.  
  193.      The predators statement can be used to establish an initial number of
  194.      predators. If it is not included or a control file is not used then
  195.      one predator for each ten bugs will be used at the start of the
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      program. The statement given above will cause three predators to be
  203.      present when the game starts. If the value in the predators statement
  204.      is set to zero then there will not be any predators at the start of
  205.      the program and none will periodically wander into the environment.
  206.      However, Predators can still be introduced through the special keys
  207.      listed below. The range of initial predators can fall between zero and
  208.      fifty.
  209.  
  210.      Addpredator 15
  211.  
  212.      This statement can be used to determine how many years, on average,
  213.      will divide the times when a predator periodically wanders into the
  214.      environment. It should be remembered that this is a random process
  215.      therefore it is possible for a predator to appear on two successive
  216.      years when the interval is set to something like every fifteen years
  217.      as it is above. The range of values can be any whole number greater
  218.      than zero.
  219.  
  220.      Linked negative
  221.  
  222.      The linked statement will allow the user to explore the effects of
  223.      linking two factors at the time of change (reproduction). These
  224.      factors are visual range and energy use. The two options for this
  225.      statement are positive and negative. The result of linkage means that
  226.      at the time of reproduction when change can take place, the nature of
  227.      the change in one factor will be related to the change in the other.
  228.      When they are positively linked an increase in visual range will be
  229.      associated with an increase in energy usage or a decrease in one would
  230.      also mean a decrease in the other. For negative linkage if one factor
  231.      increases the other will decrease. If this statement is not used or a
  232.      control file is not used then these two factors will not be linked.
  233.      They can then change independently of each other.
  234.  
  235.      Pattern 1 OOOOXXXXOOOO
  236.  
  237.      The pattern statement is used to establish a pattern of positions of
  238.      fertile land for plant growth. The second value in the statement is
  239.      the row number starting with the top of the screen. There are a total
  240.      of six possible rows. The third field is a string twelve positions in
  241.      length. Each position represents one of twelve columns across the
  242.      screen. Where the X's are located, that column and row will have
  243.      fertile land. The other positions in the string can be filled with any
  244.      character. The pattern statements need not be in row order, however,
  245.      it is easier to visualize if they are. When this statement is used the
  246.      density statement will be overridden.
  247.  
  248. Special Keys
  249.  
  250. There are two groups of special keys. The first is a single key that allows
  251. you to exit the program prior to the death of the final bug (handy when a
  252. equilibrium state is established). This is done by pressing the 'Q' key.
  253.  
  254. The others are the ten number keys on the key pad or the top of the
  255. keyboard. When using the keypad they must be used as number keys not
  256. direction keys. Pressing one of these keys when the program is in operation
  257. will introduce a predator at a random location within the corresponding
  258. area of the screen; i.e. 7 is upper left, 5 is center, and 3 lower right.
  259. The zero key will place a predator in some random location on the entire
  260. screen.
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269. Report File
  270.  
  271. After the program ends you will find a report file 'BALIVE.REP' on your
  272. disk. This is a summary of births, deaths and the status of the changeable
  273. factors for bugs and predators for each year. This is the data that you may
  274. use to test various scenarios that you establish through the control file.
  275. The next time the program is run this file will be overwritten by a new
  276. file so change its name if you want to save it.
  277.  
  278.  
  279.  
  280.                    Please send a shareware contribution
  281.                                  of $10 to
  282.  
  283.                               Acinom Software
  284.                              7301 Lanham Lane
  285.                               Edina, MN 55439
  286.  
  287.  
  288. 1 There are only two seasons; Summer and Winter.
  289. 2 I will let you try and figure out this point.
  290. 3 The other way to terminate the program is to press the Q key.
  291. 4 Summer's bar is green and winter's bar is gray.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.          ----------------end-of-author's-documentation---------------
  334.  
  335.                          Software Library Information:
  336.  
  337.                     This disk copy provided as a service of
  338.  
  339.                            Public (software) Library
  340.  
  341.          We are not the authors of this program, nor are we associated
  342.          with the author in any way other than as a distributor of the
  343.          program in accordance with the author's terms of distribution.
  344.  
  345.          Please direct shareware payments and specific questions about
  346.          this program to the author of the program, whose name appears
  347.          elsewhere in  this documentation. If you have trouble getting
  348.          in touch with the author,  we will do whatever we can to help
  349.          you with your questions. All programs have been tested and do
  350.          run.  To report problems,  please use the form that is in the
  351.          file PROBLEM.DOC on many of our disks or in other written for-
  352.          mat with screen printouts, if possible.  PsL cannot debug pro-
  353.          programs over the telephone, though we can answer questions.
  354.  
  355.          Disks in the PsL are updated  monthly,  so if you did not get
  356.          this disk directly from the PsL, you should be aware that the
  357.          files in this set may no longer be the current versions. Also,
  358.          if you got this disk from another vendor and are having prob-
  359.          lems,  be aware that  some files may have become corrupted or
  360.          lost by that vendor. Get a current, working disk from PsL.
  361.  
  362.          For a copy of the latest monthly software library newsletter
  363.          and a list of the 2,000+ disks in the library, call or write
  364.  
  365.                            Public (software) Library
  366.                                P.O.Box 35705 - F
  367.                             Houston, TX 77235-5705
  368.  
  369.                                 1-800-2424-PSL
  370.                                  MC/Visa/AmEx
  371.  
  372.                           Outside of U.S. or in Texas
  373.                           or for general information,
  374.                               Call 1-713-524-6394
  375.  
  376.                           PsL also has an outstanding
  377.                           catalog for the Macintosh.
  378.  
  379.